Skip to content

feat: add Qiita, note.com adapters & Bluesky search-posts#529

Open
lhzxbsdr wants to merge 4 commits intojackwener:mainfrom
lhzxbsdr:main
Open

feat: add Qiita, note.com adapters & Bluesky search-posts#529
lhzxbsdr wants to merge 4 commits intojackwener:mainfrom
lhzxbsdr:main

Conversation

@lhzxbsdr
Copy link
Copy Markdown

@lhzxbsdr lhzxbsdr commented Mar 27, 2026 •
edited
Loading

Description

Add three new platform adapters for cold-start user discovery across Japanese and decentralized social platforms.

Closes #561

New adapters

  • Qiita — search, user, articles (public API v2, no auth)
  • note.com — search (cookie/DOM), user, articles (public API)
  • Bluesky — search-posts (public AT Protocol API, complements existing actor search)

Type of Change

  • 🌐 New site adapter

Checklist

  • I ran the checks relevant to this PR
  • I updated tests or docs if needed
  • I included output or screenshots when useful

Documentation (if adding/modifying an adapter)

  • Added doc page under docs/adapters/ (if new adapter)
  • Updated docs/adapters/index.md table (if new adapter)
  • Updated sidebar in docs/.vitepress/config.mts (if new adapter)
  • Updated README.md / README.zh-CN.md when command discoverability changed
  • Used positional args for the command's primary subject unless a named flag is clearly better
  • Normalized expected adapter failures to CliError subclasses instead of raw Error

Screenshots / Output

Qiita

$ opencli qiita search "ChatGPT" --limit 3
┌──────┬───────────────────────────────┬──────────────┬───────┬──────────────────────┬──────────────────────────────┐
│ Rank │ Title                         │ Author       │ Likes │ Tags                 │ Url                          │
├──────┼───────────────────────────────┼──────────────┼───────┼──────────────────────┼──────────────────────────────┤
│ 1    │ Jupyter Notebookで親ディレ... │ maskot1977   │ 0     │ Python, ChatGPT      │ https://qiita.com/maskot1... │
│ 2    │ OWASP MCP Top 10が出る前に... │ murata-seiji │ 0     │ Security, owasp, MCP │ https://qiita.com/murata-... │
│ 3    │ Claude Memory入門...          │ kai_kou      │ 0     │ Python, Claude       │ https://qiita.com/kai_kou... │
└──────┴───────────────────────────────┴──────────────┴───────┴──────────────────────┴──────────────────────────────┘

$ opencli qiita user jnchito
┌─────────┬─────────────┬──────────────────────┬───────────┬───────┬───────────────────────────┐
│ Id      │ Name        │ Bio                  │ Followers │ Items │ Url                       │
├─────────┼─────────────┼──────────────────────┼───────────┼───────┼───────────────────────────┤
│ jnchito │ Junichi Ito │ Rubyプログラマ...    │ 8200      │ 402   │ https://qiita.com/jnchito │
└─────────┴─────────────┴──────────────────────┴───────────┴───────┴───────────────────────────┘

$ opencli qiita articles jnchito --limit 3
┌──────┬─────────────────────────────────┬───────┬────────────┬──────────────────────────────┐
│ Rank │ Title                           │ Likes │ Created    │ Url                          │
├──────┼─────────────────────────────────┼───────┼────────────┼──────────────────────────────┤
│ 1    │ after_findでN+1問題が起きる     │ 3     │ 2026-03-26 │ https://qiita.com/jnchito... │
│ 2    │ Rubyのシンボルって何？          │ 13    │ 2026-02-05 │ https://qiita.com/jnchito... │
│ 3    │ Ruby 4.0で発生する差異について  │ 11    │ 2026-01-24 │ https://qiita.com/jnchito... │
└──────┴─────────────────────────────────┴───────┴────────────┴──────────────────────────────┘

Bluesky

$ opencli bluesky profile jay.bsky.team
┌───────────────┬────────┬───────────┬───────┬──────────────────────────────────────────────┐
│ Handle        │ Name   │ Followers │ Posts │ Description                                  │
├───────────────┼────────┼───────────┼───────┼──────────────────────────────────────────────┤
│ jay.bsky.team │ Jay 🦋 │ 596559    │ 4004  │ Founder & Chief Innovation Officer @ Bluesky │
└───────────────┴────────┴───────────┴───────┴──────────────────────────────────────────────┘

note.com

$ opencli note user masuyohasiri
┌──────────────┬───────────────────────┬──────────────────────────┬───────────┬──────────┬───────────────────────────────┐
│ Id           │ Name                  │ Bio                      │ Followers │ Articles │ Url                           │
├──────────────┼───────────────────────┼──────────────────────────┼───────────┼──────────┼───────────────────────────────┤
│ masuyohasiri │ 知的労働業務をなくす… │ 「地味に死ぬ業務を一瞬…  │ 90        │ 222      │ https://note.com/masuyohasiri │
└──────────────┴───────────────────────┴──────────────────────────┴───────────┴──────────┘

$ opencli note articles masuyohasiri --limit 3
┌──────┬──────────────────────────────┬───────┬────────────┬───────────────────────────────────────────────┐
│ Rank │ Title                        │ Likes │ Created    │ Url                                           │
├──────┼──────────────────────────────┼───────┼────────────┼───────────────────────────────────────────────┤
│ 1    │ GASでロジレスからスプレッド…  │ 12    │ 2023-12-24 │ https://note.com/masuyohasiri/n/nfbe75e14e213 │
│ 2    │ 03_コールとプット             │ 0     │ 2026-03-08 │ https://note.com/masuyohasiri/n/n9199dba31d58 │
│ 3    │ 02_オプションとは             │ 0     │ 2026-03-08 │ https://note.com/masuyohasiri/n/n84e883816039 │
└──────┴──────────────────────────────┴───────┴────────────┴───────────────────────────────────────────────┘

Unit tests

Test Files  33 passed (33)
     Tests  406 passed (406)

🤖 Generated with Claude Code

@lhzxbsdr lhzxbsdr mentioned this pull request Mar 28, 2026
Open
1 task
@lhzxbsdr lhzxbsdr changed the title feat: add Qiita, note.com adapters & Bluesky search-posts, fix macOS Browser Bridge feat: add Qiita, note.com adapters & Bluesky search-posts Mar 28, 2026
lhzxbsdr and others added 4 commits March 29, 2026 06:24
@lhzxbsdr @claude
feat: add Qiita adapter (search, user, articles)
28b6545 
Public REST API v2, no auth required.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lhzxbsdr @claude
feat: add Bluesky search-posts command
75cf59e 
Search posts via AT Protocol public API (app.bsky.feed.searchPosts).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lhzxbsdr @claude
feat: add note.com adapter (search, user, articles)
cc9120e 
User and articles use public API (no auth). Search uses cookie strategy
(note.com requires login for search endpoint).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lhzxbsdr @claude
docs: add Qiita and note.com adapter pages, update Bluesky and index
603c67e 
- Add doc pages for Qiita and note.com adapters
- Add search-posts to Bluesky doc page
- Add Qiita and note.com to adapter index table
- Add sidebar entries in VitePress config
- Add entries to README.zh-CN.md adapter table

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Astro-Han
Astro-Han reviewed Apr 2, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@Astro-Han Astro-Han left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice PR — clean YAML adapters, good public API choices, docs are thorough. Two small things:

  1. README.md (English) not updated — only README.zh-CN.md has the new Qiita/note.com rows. The adapter checklist rule asks for both READMEs to stay in sync.

  2. Bluesky search-posts missing from README tables — neither README's bluesky row includes the new command.

Other than that, LGTM.

@Astro-Han
Copy link
Copy Markdown
Contributor

Astro-Han commented Apr 2, 2026

Follow-up to my earlier review: note search currently interpolates the raw user query directly into the navigation URL:

- navigate: "https://note.com/search?q=${{ args.query }}&context=note&mode=search"

That works for simple keywords, but it breaks for queries containing reserved URL characters such as &, #, or =. For example, C&C would be split at &, and foo#bar would turn part of the query into a fragment instead of search text.

So this adapter should URL-encode the query before navigation, otherwise some valid searches will silently become different searches.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

1 more reviewer

@Astro-Han Astro-Han Astro-Han left review comments

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Site]: Qiita, note.com, Bluesky search-posts

2 participants

@lhzxbsdr @Astro-Han